home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / adamaker.zip / ADAMAKER.DOC < prev    next >
Text File  |  1990-07-03  |  15KB  |  255 lines
  1.                           ADAMAKER.COM DOCUMENTATION
  2.  
  3. ** TO CREATE AN ADAM DISK WITH ADAMAKER:
  4.      1. Put a blank disk in A: and type "FORMAT A:/1/8" (without the quotes)
  5.         and tap the Enter key.  When asked: "another (Y/N)?" tap "N" Enter.
  6.      2. Run ADAMAKER.  After reading each of the two informational screens,
  7.         tap the letter "Y" key (don't tap Enter, it's not required).
  8.      ** If errors occur, read the information displayed.  It may help you to
  9.         find and solve the problem.  Floppy disks and disk drives which work
  10.         just fine for ordinary daily use MAY NOT WORK with this program.  In
  11.         taking precautions to ensure a that valid ADAM disk is produced, this
  12.         program will report even the slightest difficulty and then abort.  If
  13.         you experience repeated or frequent problems with this program, there
  14.         is a possibility that the disks or even the drive itself may have a
  15.         defect too slight to appear in more normal daily use.  In such a case
  16.         it would be wise to remedy the problem to avoid possible loss of your
  17.         valuable disk files, should the problem later grow worse.
  18.  
  19.  
  20.                         LICENSE AND MODIFICATION RULES
  21.  
  22.           The software and information in this archive is provided on an
  23.     "as is" basis and the author makes no warranty, express or implied, as
  24.     to its usefulness or fitness for any purpose.  No fee is charged for the
  25.     use of this software, and source code is provided on the following
  26.     understandings:
  27.  
  28.             1.  The software must be distributed in a complete fashion,
  29.     including all text files in the original archive.
  30.  
  31.             2.  No modification of the software may be made that changes or
  32.     obliterates the copyrights on the software in any way.
  33.  
  34.             3.  The software, and all other contents of the archive,
  35.     including source and text files, is copyright John Wiley.  All Rights
  36.     Reserved under all applicable copyright laws and conventions worldwide.
  37.  
  38.             4.  If you desire to modify the software, you may do so provided
  39.     that the above restrictions are observed and that it is not publicly
  40.     distributed in the modified form.   Such modifications must be solely
  41.     for your personal use.   Any modifications that are to be distributed
  42.     publicly by any means must first be cleared in writing with the author,
  43.     John Wiley or Stuart Schechter, who may be contacted care of:
  44.                                             The San Diego Computer Society
  45.                                             PO Box 81444, San Diego, CA.
  46.                                             92138
  47.  
  48.     John Wiley
  49.     July 4, 1990                         DESCRIPTION & UNASSEMBLED CODE
  50.  
  51.      This program makes an ADAM "DOS" disk in A: by writing 7 Tracks stored
  52.   within the program starting at Offset 1000.  Only 2 Sectors of the last
  53.   Track written are actually used by ADAM.  The others are for data files
  54.   on an ADAM "DOS" disk, so data in that Track (6) is lost.  Other data on
  55.   the ADAM disk can still be recovered with the ADAMDISK program.  ADAM
  56.   "data" disks use only part of the first Track (0) for system info, so much
  57.   more data can be wiped out on an ADAM "data" disk by ADAMAKER.  The best
  58.   course is to use a blank formatted ADAM or MS-DOS floppy.  To make a blank
  59.   MS-DOS floppy for ADAMAKER, be sure to use the /8 switch.  This makes it
  60.   8 Sectors per track, rather than the standard 9 Sectors used in 360k drives.
  61.   ADAM disks are also single-sided, so you can save time by only formatting
  62.   one side.  Thus, FORMAT A:/1/8 before running ADAMAKER on an MS-DOS disk.
  63.  
  64. 100 E9FD00        JMP    0200 ; Skip "intro" data area (ends with ^Z at 1F9).
  65.  
  66.                             INTRO MESSAGE DATA AREA
  67. 100           54 68 69 73 20-70 72 6F 67 72 61 6D 20      This program
  68. 110  77 69 6C 6C 20 6D 61 6B-65 20 61 20 43 6F 6C 65   will make a Cole
  69. 120  63 6F 20 41 44 41 4D 20-44 69 73 6B 20 4D 61 6E   co ADAM Disk Man
  70. 130  61 67 65 72 20 22 44 4F-53 22 20 64 69 73 6B 20   ager "DOS" disk
  71. 140  69 6E 20 64 72 69 76 65-20 41 3A 0D 0A 0A 09 09   in drive A:.....
  72. 150  09 2A 2A 20 42 45 46 4F-52 45 20 59 4F 55 20 42   .** BEFORE YOU B
  73. 160  45 47 49 4E 20 2A 2A 0D-0A 45 69 74 68 65 72 20   EGIN **..Either
  74. 170  70 72 65 70 61 72 65 20-61 6E 20 4D 53 2D 44 4F   prepare an MS-DO
  75. 180  53 20 64 69 73 6B 20 28-46 4F 52 4D 41 54 20 41   S disk (FORMAT A
  76. 190  3A 2F 31 2F 38 29 2C 20-6F 72 20 70 75 74 20 61   :/1/8), or put a
  77. 1A0  6E 20 41 44 41 4D 20 64-69 73 6B 20 69 6E 20 41   n ADAM disk in A
  78. 1B0  3A 0D 0A 0A 07 57 41 52-4E 49 4E 47 21 21 20 20   :....WARNING!!
  79. 1C0  44 41 54 41 20 4F 4E 20-44 49 53 4B 20 49 4E 20   DATA ON DISK IN
  80. 1D0  44 52 49 56 45 20 41 3A-20 57 49 4C 4C 20 42 45   DRIVE A: WILL BE
  81. 1E0  20 4C 4F 53 54 21 0D 0A-0A 43 4F 4E 54 49 4E 55    LOST!...CONTINU
  82. 1F0  45 20 28 79 2F 4E 29 3F-24 1A                     E (y/N)?$.
  83.  
  84.                                START OF PROGRAM
  85. 200 B409          MOV    AH,09     ;Display String DOS Call
  86. 202 BA0301        MOV    DX,0103   ; text at 103 - "intro" screen & "(y/N)?"
  87. 205 CD21          INT    21        ; do it.
  88. 207 90            NOP    ; No OPeration - used between modules for readability.
  89. 208 E80500        CALL   0210      ;Get USER answer to "(y/N)?" prompt.
  90. 20B 90            NOP
  91. 20C EB12          JMP    0220      ; Continue to DETAILS module.
  92.  
  93.                                  USER ANSWER
  94. 210 B401          MOV    AH,01     ;Keyboard Input with Echo DOS Call
  95. 212 CD21          INT    21        ; get answer to "(y/N)?" prompt
  96. 214 245F          AND    AL,5F     ; convert "y" to "Y"
  97. 216 3C59          CMP    AL,59     ; see if USER answer = "Y"
  98. 218 7502          JNZ    021C      ; If not "Y" then goto TERMINATE
  99. 21A C3            RET              ; Else RETurn to calling process.
  100. 21B 90            NOP
  101. 21C CD20          INT    20        ;TERMINATE PROGRAM DOS INTERRUPT.                DISPLAY OPERATIONAL DETAILS AND QUERY USER AGAIN
  102. 220 B409          MOV    AH,09     ;Display String
  103. 222 BA3002        MOV    DX,0230   ; at 230 - "details" & "(y/N)?"
  104. 225 CD21          INT    21
  105. 227 90            NOP
  106. 228 E8E5FF        CALL   0210      ;Get USER answer, if not "Y" TERMINATE.
  107. 22B 90            NOP
  108. 22C E9D100        JMP    0300      ;Skip past "details" data to WRITING msg.
  109.  
  110.                       OPERATIONAL DETAILS DATA & QUERY
  111. 230  0D 0A 0A 0A 2A 20 4D 53-2D 44 4F 53 20 64 69 73   ....* MS-DOS dis
  112. 240  6B 73 20 6D 75 73 74 20-62 65 20 38 20 53 65 63   ks must be 8 Sec
  113. 250  74 6F 72 73 20 70 65 72-20 54 72 61 63 6B 20 28   tors per Track (
  114. 260  46 4F 52 4D 41 54 20 41-3A 2F 31 2F 38 29 20 66   FORMAT A:/1/8) f
  115. 270  69 72 73 74 2E 0D 0A 4E-4F 54 45 3A 20 45 78 69   irst...NOTE: Exi
  116. 280  73 74 69 6E 67 20 64 61-74 61 20 6D 61 79 20 62   sting data may b
  117. 290  65 20 72 65 63 6F 76 65-72 61 62 6C 65 20 6F 6E   e recoverable on
  118. 2A0  20 61 6E 20 41 44 41 4D-20 64 69 73 6B 20 61 66    an ADAM disk af
  119. 2B0  74 65 72 20 41 44 41 4D-41 4B 45 52 2E 0D 0A 0A   ter ADAMAKER....
  120. 2C0  4D 41 4B 45 20 54 48 45-20 44 49 53 4B 20 49 4E   MAKE THE DISK IN
  121. 2D0  20 41 3A 20 41 4E 20 41-44 41 4D 20 44 49 53 4B    A: AN ADAM DISK
  122. 2E0  4D 41 4E 41 47 45 52 20-42 4F 4F 54 41 42 4C 45   MANAGER BOOTABLE
  123. 2F0  20 44 49 53 4B 20 28 79-2F 4E 29 3F 20 24 00 00    DISK (y/N)? $..
  124.  
  125.                            DISPLAY "WRITING" MESSAGE
  126. 300 B409          MOV    AH,09     ;Display String
  127. 302 BA0903        MOV    DX,0309   ; at 309 ("Writing...")
  128. 305 CD21          INT    21
  129. 307 EB2B          JMP    0334      ;Skip data area to INITIALIZE for write.
  130.  
  131.                           "WRITING" MESSAGE DATA AREA
  132. 300                             0D 0A 0A 57 72 69 74            ...Writ
  133. 310  69 6E 67 20 41 44 41 4D-20 74 72 61 63 6B 73 20   ing ADAM tracks
  134. 320  6F 6E 20 41 3A 20 24 07-45 52 52 4F 52 20 24 07   on A: $.ERROR $.
  135.  
  136.                        INITIALIZE FOR FIRST TRACK WRITE
  137. 334 BB0010        MOV    BX,1000   ;Buffer Offset for first Track of ADAM.
  138. 337 53            PUSH   BX        ;Save for use again.
  139. 338 B90100